/*
 * Copyright 2009-2009 Tanesha Project. All rights reserved.
 * 
 * Redistribution and use in source and binary forms, with or without modification, 
 * are permitted provided that the following conditions are met:
 * 
 *    1. Redistributions of source code must retain the above copyright notice, 
 *    	 this list of conditions and the following disclaimer.
 *    2. Redistributions in binary form must reproduce the above copyright notice,
 *    	 this list of conditions and the following disclaimer in the documentation 
 *    	 and/or other materials provided with the distribution.
 * 
 * THIS SOFTWARE IS PROVIDED BY THE FREEBSD PROJECT ``AS IS'' AND ANY EXPRESS OR 
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 
 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT 
 * SHALL THE FREEBSD PROJECT OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, 
 * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 
 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE 
 * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 *  OF THE POSSIBILITY OF SUCH DAMAGE.
 * 
 * The views and conclusions contained in the software and documentation are those 
 * of the authors and should not be interpreted as representing official policies, 
 * either expressed or implied, of the Tanesha Project.
 */
package com.google.api.chart.features;


/**
 * Marks support for special bar chart information.
 * 
 * @author sorenad
 */
public interface BarFeature<T> {
	
	/**
	 * Specifies that the bars in the chart will autosize, using a fixed spacing
	 * and group spacing.
	 * 
	 * @param barSpacing
	 * @param groupSpacing
	 * @return
	 */
	public T autosize(double barSpacing, double groupSpacing);

	/**
	 * Specifies that the bars should autosize to fit in the chart.
	 * 
	 * @return
	 */
	public T autosize();

	/**
	 * Specifies that the bars should use a fixed width, spacing, and group spacing.
	 * 
	 * @param width
	 * @param barSpacing
	 * @param groupSpacing
	 * @return
	 */
	public T fixed(double width, double barSpacing, double groupSpacing);

	/**
	 * Specifies that the bars should be relative sized.
	 * 
	 * @param barSpacing
	 * @param groupSpacing
	 * @return
	 */
	public T relative(double barSpacing, double groupSpacing);
	
	/**
	 * Specifies where to put zerolines in the barchart.
	 * 
	 * @param percents
	 * @return
	 */
	public T zerolines(double... percents);

}
